home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / scsi_info.z / scsi_info
Encoding:
Text File  |  2001-04-17  |  3.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ssssccccssssiiii____iiiinnnnffffoooo((((DDDD3333XXXX))))                                                  ssssccccssssiiii____iiiinnnnffffoooo((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      scsi_info - get information about a SCSI device
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ssssccccssssiiii....hhhh>>>>
  14.  
  15.      ssssttttrrrruuuucccctttt ssssccccssssiiii____ttttaaaarrrrggggeeeetttt____iiiinnnnffffoooo ****
  16.      ((((****ssssccccssssiiii____iiiinnnnffffoooo))))((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _l_u_n__v_h_d_l))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      The host adapter _s_c_s_i__i_n_f_o function issues an Inquiry command to the
  20.      device corresponding to _l_u_n__v_h_d_l, returning a pointer to a
  21.      _s_c_s_i__t_a_r_g_e_t__i_n_f_o structure, which contains at least the following fields:
  22.  
  23.              u_char    *si_inq;       /* inquiry data */
  24.              u_char    *si_sense;     /* sense data from last request sense */
  25.              u_char     si_maxq;      /* maximum queue depth for driver */
  26.              u_char     si_qdepth;    /* max queue depth so far */
  27.              u_char     si_qlimit:1;  /* boolean "max queue depth reached"? */
  28.              uint       si_ha_status; /* SRH_* status bits, if supported */
  29.  
  30.  
  31.      There is no kernel object called scsi_info; rather, there is a pointer to
  32.      each host adapter's scsi_info function in the sci_info field of the
  33.      scsi_ctlr_info structure, which is attached to the vertex corresponding
  34.      to the host adapter.
  35.  
  36. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  37.      If the given device does not exist, or there is an error getting the
  38.      data, NULL is returned.
  39.  
  40. NNNNOOOOTTTTEEEESSSS
  41.      _s_c_s_i__i_n_f_o is stored as a function pointer in the information hanging off
  42.      the vertex handle corresponding to the host adapter in the hwgraph.
  43.      Given a _l_u_n__v_h_d_l (vertex handle of the device) the scsi_info function can
  44.      be called as follows:
  45.  
  46.               scsi_lun_info_t           *scsi_lun_info;
  47.               scsi_target_info_t        *scsi_info;
  48.             ...
  49.               scsi_lun_info = scsi_lun_info_get(lun_vhdl);
  50.               scsi_info = (*(SCI_INQ(
  51.                                    STI_CTLR_INFO(
  52.                                    SLI_TARG_INFO(scsi_lun_info)))))(lun_vhdl);
  53.  
  54.  
  55. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  56.      comments in /usr/include/sys/scsi.h, hwgraph.intro(D4X), scsi_alloc(D3X),
  57.      scsi_command(D3X), scsi_free(D3X), scsi_ioctl(D3X), scsi_abort(D3X), SCSI
  58.      chapter of the IRIX Device Driver Programmer's Guide
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.